home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / scrnsvrs / stblbin.arc / STBLANK.TXT < prev    next >
Text File  |  1989-04-06  |  14KB  |  324 lines
  1. ST Blank - The Monitor Protector : Version 2.0.0
  2. ================================================
  3.  
  4. (c) Copyright 1989, 1990, 1991, 1992, 1993 Mathew Lodge. This program 
  5. is NOT public domain, but you are free to copy it as long as this 
  6. text file accompanies the executable program and resource file. This 
  7. program may not be sold.
  8.  
  9.  
  10. Abstract
  11. ========
  12.  
  13. ST Blank is a utility to blank your monitor screen after a user 
  14. definable period of inactivity.
  15.  
  16.  
  17. Installation
  18. ============
  19.  
  20. ST Blank comes in two parts: An AUTO folder program, STBLPRG.PRG, a 
  21. control program, STBLACC.ACC, and the resource for the control 
  22. program STBLANK.RSC.
  23.  
  24. STBLPRG.PRG should be placed in the AUTO folder of your boot disk. 
  25. The control program can be used as a desk accessory by placing 
  26. STBLACC.ACC and STBLANK.RSC in the root directory of your boot disk. 
  27. Your ST must be then rebooted before ST Blank will be installed.
  28.  
  29. The control program can also be run as a stand alone program, simply 
  30. by renaming it from STBLACC.ACC to STBLACC.PRG. Make sure that 
  31. STBLANK.RSC is in the same directory as the program, and then 
  32. double-click STBLACC.PRG.
  33.  
  34.  
  35. Use
  36. ===
  37.  
  38. Selecting the ST Blank item from the desk menu (or double clicking 
  39. STBLACC.PRG) allows you to set the various parameters of ST Blank. 
  40. This includes the delay before blanking in minutes and seconds. 
  41. Blanking occurs when the ST has been inactive for this user definable 
  42. amount of time. The program defines activity as mouse movement and 
  43. clicks, key depression and release, and BIOS character output to any 
  44. device other than the intelligent keyboard controller, IKBD.
  45.  
  46. From the dialogue you can also make the screen blank immediately, and 
  47. turn blanking off. Underneath the "Star Display Options" you can set 
  48. whether you want a star-trek type display when the screen is blanked 
  49. (more information on this below). The speed of the star display is 
  50. also configurable - the higher the speed number, the slower the star 
  51. display. The "Test" button blanks the screen straight away (without 
  52. removing the dialogue) to allow easy testing of different star 
  53. speeds.
  54.  
  55. While the screen is blanked, you get a display of stars similar to 
  56. that used in innumerable space games, as if travelling through space. 
  57. (This idea is shamelessly blagged from the Macintosh screen saver 
  58. "Stars!" at the request of Steve Cassidy). The speed of the star 
  59. display is configurable (see above). Any activity (definition of 
  60. "activity" given above) will restore the screen and continue.
  61.  
  62. Clicking upon the "ST Blank" title text displays a dialogue 
  63. containing various information and a thumbnail sketch of the author!
  64.  
  65. This accessory works in ALL screen resoltions currently supported by 
  66. the standard ST(E) architecture (i.e. 320x200, 640x200 and 640x400 - 
  67. NOT "Autoswitch Overscan" modes, Mega Screens or the new screen modes 
  68. of the TT and Falcon).
  69.  
  70. ST Blank works on the TT (though regrettably only in ST screen modes 
  71. -- see "In the pipeline" below) and copes with all 680x0 processors. 
  72. ST Blank has been extensively tested with various beta releases of 
  73. MultiTOS and found to work perfectly. It has not been tested on the 
  74. Falcon, because I can't find anyone who actually has one!
  75.  
  76. When the AUTO folder program starts up, it attempts to read the file 
  77. STBLANK.INF from the boot device (usually A: for those booting from 
  78. floppy, or C: for hard drive owners). This file contains all the 
  79. configuration information. If this file does not exist, an error 
  80. message will be printed, but sensible defaults will be installed. 
  81. Using the controlling accessory, you can save your own configuration 
  82. by clicking on the "Save" button, and it will be used next time you 
  83. restart your ST. You can also re-load your configuration at any time 
  84. with the "Load" button.
  85.  
  86. If any errors occur during initialisation (e.g. can't find memory 
  87. resident part of ST Blank or no resource file), then you won't get 
  88. the ST Blank title on the Desk menu, but the accessory won't crash 
  89. your machine. It will, however, take up memory space. An error 
  90. message or alert will explain what went wrong.
  91.  
  92. ST Blank was written in 68000 assembly language to make it as compact 
  93. as possible. I feel that all memory resident programs should be as 
  94. small as possible - I had a 520ST for a few years, and was appalled 
  95. at the huge size of one poor screen saver. ST Blank has grown as 
  96. features have been added, but I hope that it is still small and 
  97. useful enough to take a regular place in your AUTO folder / accessory 
  98. menu.
  99.  
  100.  
  101. Known Problems
  102. ==============
  103.  
  104. POOLFIX3 and POOLFIX4 : Both these programs (that fix a bug in the 
  105. GEMDOS memory manager of TOS 1.4) like to run first in your AUTO 
  106. folder. Don't try to put STBLPRG.PRG (or any other program) before 
  107. them -- you'll get a system crash.
  108.  
  109. TEMPUS and TEMPUS2 : When normal operation is resumed after screen 
  110. blanking, Tempus' on-screen clock will increment wildly and finally 
  111. settle at the wrong time. This is a bug in Tempus, not ST Blank. In 
  112. Tempus 2, you can avoid this by using Tempus' own screen blanking 
  113. feature instead of ST-Blank. You'll have to forgo the star display 
  114. though, and rely on Tempus' screen blanking method of disabling video 
  115. synchronisation. The Tempus method will damage some monitors in the 
  116. long run, as they hunt for a display signal to lock onto (this is 
  117. characterised by monitor "scream"). Atari USA have stated that the 
  118. Atari range of monitors can be damaged in this way.
  119.  
  120. MEGAROIDS and SMALLTALK-80 : Megamax Megaroids and Smalltalk-80 
  121. install their own IKBD packet handlers and so ST Blank will cut in 
  122. when the timer expires (it never gets to see any mouse movements or 
  123. keypresses). At this point, the only option is to reset, because ST 
  124. Blank cannot detect any activity to cancel the star display. Remember 
  125. to disable ST Blank before using either of these programs.
  126.  
  127. NEOCHROME MASTER : This program hacks wildly into the innards of your 
  128. machine, and does rather strange things with the keyboard and mouse 
  129. packet handlers. Besides this, NeoChrome Master is an illegal 
  130. derivative work of copyright Atari code -- don't use it.
  131.  
  132.  
  133. In the pipeline
  134. ===============
  135.  
  136. A list, in no particular order, of the enhancements planned (when 
  137. (if?) I have time):
  138.  
  139. 1) A CPX version of the controlling accessory.
  140. 2) A version that supports arbitrary video modes (TT, big screens, 
  141. Falcon modes, etc.)
  142. 3) A smoother star display.
  143. 4) A MiNT aware version of the .PRG that communicates via a pipe, 
  144. rather than shared memory.
  145. 5) Slot-in modules to replace the standard star display
  146.  
  147.  
  148. Technical Info.
  149. ===============
  150.  
  151. The program tries to avoid blanking the screen in the middle of disk 
  152. access, but since there's no foolproof way of checking (even looking 
  153. at flock at $43E doesn't work all of the time), this can happen. On 
  154. the ST, all disk I/O is done via Direct Memory Access, which means 
  155. that ST Blank cannot interefere with data being transferred. During 
  156. testing and in the three years since the first release there have 
  157. been no reported corruption problems, but obviously this cannot be 
  158. guaranteed. If anyone knows a foolproof method of testing for ongoing 
  159. floppy/hard disc access, then please let me know.
  160.  
  161. Any character output via the BIOS Bconout routine is counted as 
  162. "activity". This was added to prevent ST Blank cutting in during 
  163. printing and file transfer. However, if the file transfer is all one 
  164. way (i.e. into the ST) then ST Blank will still cut in. I believe 
  165. that this is not the case with most popular file transfer protocols 
  166. (Kermit, X-,Y-, Z-Modem etc.) Note that if a program has its own 
  167. device drivers that do not call the BIOS (e.g. serial port driver of 
  168. First Word (Plus), "Printer (direct)" driver of That's Write and 
  169. Write On), then ST Blank won't know about the output.
  170.  
  171.  
  172. This program installs four of its own exception handlers:
  173.  
  174. 1) The IKBD interrupt vector (see XBIOS 34 (Kdbvbase), IKBDSYS 
  175. vector).
  176. 2) MFP level 5 interrupt, Time